home *** CD-ROM | disk | FTP | other *** search
/ Whiteline: Alpha / Whiteline Alpha.iso / progtool / c / datamake / data.txt < prev    next >
Encoding:
Text File  |  1994-09-22  |  5.4 KB  |  117 lines
  1.  DATA.TXT                                                          Seite 1 von 2
  2.  
  3.  
  4.                                                                        22.12.93
  5.  
  6.                         Anleitung zu DataMaker (Deutsch)
  7.  
  8.     Mit dem DataMaker (DM) haben Sie ein Werkzeug zur Verfügung,  das dann sehr
  9.  von nutzen ist,  wenn Sie selbst in der Programmiersprache C programmieren. DM
  10.  konvertiert beliebige Dateien in ein C verständliches Format,  wobei Sie unter
  11.  drei  verschiedenen  Komprimierungsarten wählen können.  Natürlich  sind  alle
  12.  drei kompatibel zu der Programmiersprache C.  Voraussetzung ist natürlich, daß
  13.  Sie die Programmierung in C beherrschen.
  14.  
  15.  1. Betriebsarten und Computerkonfiguration
  16.  
  17.     DM  sollte auf jedem ATARI mit jedem TOS laufen.  Geschrieben und  getestet
  18.  wurde es auf einem Falcon030,  wo es fehlerfrei seinen Testdienst  verrichtete
  19.  und  der  war  unter  anderen,  eine  300  Kb  große  Sample-Datei  in  Ascii-
  20.  Komprimierung  (das ist die aufwendigste und beste) zu  konvertieren.  Pure  C
  21.  nahm danach diese Datei ohne zu meckern an.  An Zusatzperipherie ist nur  eine
  22.  Festplatte empfehlenswert, aber nicht nötig.
  23.  DM  läuft sowohl als Accessory sowie als Programm und  unter  MultiTOS.  Unter
  24.  MultiTOS verhält es sich wie ein Accessory.
  25.  
  26.  2. Beschreibung der Funktionen
  27.  
  28.     Nach dem Start erscheint ein Fenster,  in dem alle Aktionen getätigt werden
  29.  müssen.  Ganz  oben befindet sich eine Menüleiste,  darunter drei  Textfelder:
  30.  Identifier,  LEN-Mark und MaximumLen.  Unter diesen Textfeldern befinden  sich
  31.  die Komprimierungsschalter:  Hex, Dec und Ascii. Dann folgen die Aktionsknöpfe
  32.  zum Laden Source, Sichern Dest-C und zum Verlassen des Programms Exit.
  33.  
  34.  Beginnen wir mit der Menüleiste.  Der erste Eintrag heißt 'File'. Unter diesem
  35.  Eintrag  befinden  sich  'Load Source' zum  Laden  einer  x-beliebigen  Datei.
  36.  'Save destination' zum Sichern als C-Include-Datei.  'Information' zeigt  eine
  37.  Infobox. 'Quit' verläßt letztendlich das Programm.
  38.  Der  zweite  Eintrag  heißt 'Options'.  Unter  diesem  Eintrag  befinden  sich
  39.  'Pulldown  menus'  zum Einstellen des Verhaltens der  Menüleiste.  Ist  dieser
  40.  Eintrag  abgehakt,  muß  man  zuerst  die  Menüleiste  anklicken,  um  sie  zu
  41.  aktivieren,  ansonsten verhält sie sich wie eine normale  Menüleiste.  'Center
  42.  dialogs'  bestimmt,  ob Dialogboxen zentriert oder an Mausposition  ausgegeben
  43.  werden  sollen.  'Help' ruft die Online-Hilfe auf,  wo man zu  jeder  Funktion
  44.  eine kurze Hilfe bekommt.
  45.  
  46.  In das Textfeld 'Identifier' wird der C Variablenname eingetragen,  unter  den
  47.  C  das konvertierte File später wieder aufgerufen werden soll.  Der  name  muß
  48.  den C Konventionen entsprechen.  Nach dem Laden wird in das Textfeld der  Name
  49.  der geladenen Datei automatisch eingetragen.
  50.  In  das  Textfeld  'LEN-Mark' kommt der Bezeichner  für  die  Längenkonstante.
  51.  Diese  Konstante  enthält  die  Länge  des  Data's.   Auch  dieses  Feld  wird
  52.  automatisch nach dem Laden einer Datei ausgefüllt.
  53.  In das Textfeld 'MaximumLen' kommt die maximale Länge der  Originaldatei,  die
  54.  konvertiert werden soll.  Ist dieses Feld leer oder steht null darin, wird die
  55.  Originallänge benutzt.  Soll z.  B. die Hälfte einer 300000 Bytes langen Datei
  56.  konvertiert werden, ist in dieses Textfeld 150000 einzutragen.
  57.  
  58.  Die 'Output'-Schalter dienen zum Einstellen der Komprimierung.  Sie werden  in
  59.  C  alle zum selben Code verarbeitet.  Es gibt die Ausgabe  als  Hex-File,  als
  60.  Decimal-File und als Ascii-File.
  61.  
  62.  DATA.TXT                                                          Seite 2 von 2
  63.  
  64.  
  65.  
  66.  Mit  'Source'  kann eine Datei geladen und mit  'Dest-C'  geschrieben  werden.
  67.  'Exit' beendet DM.
  68.  
  69.  3. Benutzung unter C
  70.  
  71.     Die Dateien werden in C einfach 'includiert'.  Angesprochen werden kann der
  72.  Speicherplatz  über  den Identifier.  Die Daten werden als  'unsigned  char[]'
  73.  abgelegt. Ein Beispiel:
  74.  
  75.  #include <heikolib.h>
  76.  #include <tos.h>
  77.  #include <string.h>
  78.  #include "sample.h"
  79.  #include "pic.h"
  80.  
  81.  void main()
  82.  {
  83.     memmove(Physbase(), TUNNEL, TUNNEL_LEN); /* Stellt das Bild dar */
  84.     playmemory(SOUND, NULL, -999);           /* Spielt das Sample */
  85.     Crawcin();                               /* Wartet auf Taste */
  86.     endsample();                             /* Beendet das Sample */
  87.     Pterm0();                                /* Beender das Programm */
  88.  }
  89.  
  90.  Dies  ist  der C-Quelltext zu dem beigefügten  Demo-Programm  TUNNEL.TOS.  Die
  91.  Sample-Daten  befinden  sich  in  der Datei  'sample.h'  mit  den  Identifiern
  92.  'SOUND'  und SOUND_LEN.  Die Bilddaten befinden sich in der Datei 'pic.h'  mit
  93.  den  Bezeichnern 'TUNNEL' und 'TUNNEL_LEN'.  Aus diesen Dateien  compiliert  C
  94.  ein ca. 600 Kb großes Programm, indem das Sample und das Bild integriert ist.
  95.  
  96.  4. In eigener Sache
  97.  
  98.  Das Programm ist Public Domain.  Trotzdem, oder gerade deswegen würde ich mich
  99.  über eine finanzielle Anerkennung von 20 DM sehr freuen.  Zahlbar ist sie  als
  100.  Scheck oder Schein an folgende Adresse:
  101.  
  102.     Heiko Schäfer
  103.     Waldstraße 29/1
  104.  
  105.     72108 Rottenburg
  106.  
  107.     Deutschland
  108.  
  109.  Oder an folgende Bankverbindung: Postgiroamt Stuttgart
  110.                                   BLZ 600 100 70
  111.                                   Kto.Nr. 3350 80-700
  112.  
  113.  Über  mich  selbst  gibt es zu sagen,  daß ich zur  Zeit  der  Erstellung  des
  114.  Programmes  knapp 19 Jahre alt war und das Wirtschaftsgymnasium  besuchte  und
  115.  nach wie vor ein armer Schlucker bin.
  116.  
  117.